home *** CD-ROM | disk | FTP | other *** search
/ Aminet 48 / Aminet 48 (2002)(GTI - Schatztruhe)[!][Apr 2002].iso / Aminet / text / edit / vim60rt.lha / Vim / vim60 / doc / scroll.txt < prev    next >
Encoding:
Text File  |  2001-09-26  |  11.8 KB  |  300 lines
  1. *scroll.txt*    For Vim version 6.0.  Last change: 2001 Sep 19
  2.  
  3.  
  4.           VIM REFERENCE MANUAL    by Bram Moolenaar
  5.  
  6.  
  7. Scrolling                        *scrolling*
  8.  
  9. These commands move the contents of the window.  If the cursor position is
  10. moved off of the window, the cursor is moved onto the window (with
  11. 'scrolloff' screen lines around it).  A page is the number of lines in the
  12. window minus two.  The mnemonics for these commands may be a bit confusing.
  13. Remember that the commands refer to moving the window (the part of the buffer
  14. that you see) upwards or downwards in the buffer.  When the window moves
  15. upwards in the buffer, the text in the window moves downwards on your screen.
  16.  
  17. See section |03.7| of the user manual for an introduction.
  18.  
  19. 1. Scrolling downwards        |scroll-down|
  20. 2. Scrolling upwards        |scroll-up|
  21. 3. Scrolling relative to cursor    |scroll-cursor|
  22. 4. Scrolling horizontally    |scroll-horizontal|
  23. 5. Scrolling synchronously    |scroll-binding|
  24. 6. Scrolling with a mouse wheel |scroll-mouse-wheel|
  25.  
  26. ==============================================================================
  27. 1. Scrolling downwards                    *scroll-down*
  28.  
  29. The following commands move the edit window (the part of the buffer that you
  30. see) downwards (this means that more lines downwards in the text buffer can be
  31. seen):
  32.  
  33.                             *CTRL-E*
  34. CTRL-E            Scroll window [count] lines downwards in the buffer.
  35.             Mnemonic: Extra lines.
  36.  
  37.                             *CTRL-D*
  38. CTRL-D            Scroll window Downwards in the buffer.  The number of
  39.             lines comes from the 'scroll' option (default: half a
  40.             screen).  If [count] given, first set 'scroll' option
  41.             to [count].  The cursor is moved the same number of
  42.             lines down in the file (if possible; when lines wrap
  43.             and when hitting the end of the file there may be a
  44.             difference).  When the cursor is on the last line of
  45.             the buffer nothing happens and a beep is produced.
  46.             See also 'startofline' option.
  47.             {difference from vi: Vim scrolls 'scroll' screen
  48.             lines, instead of file lines; makes a difference when
  49.             lines wrap}
  50.  
  51. <S-Down>    or                *<S-Down>* *<kPageDown>*
  52. <PageDown>    or                *<PageDown>* *CTRL-F*
  53. CTRL-F            Scroll window [count] pages Forwards (downwards) in
  54.             the buffer.  See also 'startofline' option.
  55.  
  56.                             *z+*
  57. z+            Without [count]: Redraw with the line just below the
  58.             window at the top of the window.  Put the cursor in
  59.             that line, at the first non-blank in the line.
  60.             With [count]: just like "z<CR>".
  61.  
  62. ==============================================================================
  63. 2. Scrolling upwards                    *scroll-up*
  64.  
  65. The following commands move the edit window (the part of the buffer that you
  66. see) upwards (this means that more lines upwards in the text buffer can be
  67. seen):
  68.  
  69.                             *CTRL-Y*
  70. CTRL-Y            Scroll window [count] lines upwards in the buffer.
  71.             Note: When using the MS-Windows key bindings CTRL-Y is
  72.             remapped to redo.
  73.  
  74.                             *CTRL-U*
  75. CTRL-U            Scroll window Upwards in the buffer.  The number of
  76.             lines comes from the 'scroll' option (default: half a
  77.             screen).  If [count] given, first set the 'scroll'
  78.             option to [count].  The cursor is moved the same
  79.             number of lines up in the file (if possible; when
  80.             lines wrap and when hitting the end of the file there
  81.             may be a difference).  When the cursor is on the first
  82.             line of the buffer nothing happens and a beep is
  83.             produced.  See also 'startofline' option.
  84.             {difference from vi: Vim scrolls 'scroll' screen
  85.             lines, instead of file lines; makes a difference when
  86.             lines wrap}
  87.  
  88. <S-Up>        or                    *<S-Up>* *<kPageUp>*
  89. <PageUp>    or                    *<PageUp>* *CTRL-B*
  90. CTRL-B            Scroll window [count] pages Backwards (upwards) in the
  91.             buffer.  See also 'startofline' option.
  92.  
  93.                             *z^*
  94. z^            Without [count]: Redraw with the line just above the
  95.             window at the bottom of the window.  Put the cursor in
  96.             that line, at the first non-blank in the line.
  97.             With [count]: First scroll the text to put the [count]
  98.             line at the bottom of the window, then redraw with the
  99.             line which is now at the top of the window at the
  100.             bottom of the window.  Put the cursor in that line, at
  101.             the first non-blank in the line.
  102.  
  103. ==============================================================================
  104. 3. Scrolling relative to cursor                *scroll-cursor*
  105.  
  106. The following commands reposition the edit window (the part of the buffer that
  107. you see) while keeping the cursor on the same line:
  108.  
  109.                             *z<CR>*
  110. z<CR>            Redraw, line [count] at top of window (default
  111.             cursor line).  Put cursor at first non-blank in the
  112.             line.
  113.  
  114.                             *zt*
  115. zt            Like "z<CR>", but leave the cursor in the same
  116.             column.  {not in Vi}
  117.  
  118.                             *zN<CR>*
  119. z{height}<CR>        Redraw, make window {height} lines tall.  This is
  120.             useful to make the number of lines small when screen
  121.             updating is very slow.  Cannot make the height more
  122.             than the physical screen height.
  123.  
  124.                             *z.*
  125. z.            Redraw, line [count] at center of window (default
  126.             cursor line).  Put cursor at first non-blank in the
  127.             line.
  128.  
  129.                             *zz*
  130. zz            Like "z.", but leave the cursor in the same column.
  131.             Careful: If caps-lock is on, this commands becomes
  132.             "ZZ": write buffer and exit!  {not in Vi}
  133.  
  134.                             *z-*
  135. z-            Redraw, line [count] at bottom of window (default
  136.             cursor line).  Put cursor at first non-blank in the
  137.             line.
  138.  
  139.                             *zb*
  140. zb            Like "z-", but leave the cursor in the same column.
  141.             {not in Vi}
  142.  
  143. ==============================================================================
  144. 4. Scrolling horizontally                *scroll-horizontal*
  145.  
  146. For the following four commands the cursor follows the screen.  If the
  147. character that the cursor is on is moved off the screen, the cursor is moved
  148. to the closest character that is on the screen.  The value of 'sidescroll' is
  149. not used.
  150.  
  151. z<Right>    or                        *zl* *z<Right>*
  152. zl            Scroll the screen [count] characters to the left.
  153.             This only works when 'wrap' is off.  {not in Vi}
  154.  
  155. z<Left>      or                        *zh* *z<Left>*
  156. zh            Scroll the screen [count] characters to the right.
  157.             This only works when 'wrap' is off.  {not in Vi}
  158.  
  159.                             *zL*
  160. zL            Scroll the screen half a screenwidth to the left.
  161.             This only works when 'wrap' is off.  {not in Vi}
  162.  
  163.                             *zH*
  164. zH            Scroll the screen half a screenwith to the right.
  165.             This only works when 'wrap' is off.  {not in Vi}
  166.  
  167. For the following two commands the cursor is not moved in the text, only the
  168. text scrolls on the screen.
  169.  
  170.                             *zs*
  171. zs            Scroll the screen horizontally to position the cursor
  172.             at the start (left side) of the screen.  This only
  173.             works when 'wrap' is off.  {not in Vi}
  174.  
  175.                             *ze*
  176. ze            Scroll the screen horizontally to position the cursor
  177.             at the end (right side) of the screen.  This only
  178.             works when 'wrap' is off.  {not in Vi}
  179.  
  180. ==============================================================================
  181. 5. Scrolling synchronously                *scroll-binding*
  182.  
  183. Occasionally, it is desirable to bind two or more windows together such that
  184. when one window is scrolled, the other windows are scrolled also.  In Vim,
  185. windows can be given this behavior by setting the (window-specific)
  186. 'scrollbind' option.  When a window that has 'scrollbind' set is scrolled, all
  187. other 'scrollbind' windows are scrolled the same amount, if possible.  The
  188. behavior of 'scrollbind' can be modified by the 'scrollopt' option.
  189.  
  190. When a window also has the 'diff' option set, the scroll-binding uses the
  191. differences between the two buffers to synchronize the position precisely.
  192. Otherwise the following method is used.
  193.  
  194.                             *scrollbind-relative*
  195. Each 'scrollbind' window keeps track of its "relative offset," which can be
  196. thought of as the difference between the current window's vertical scroll
  197. position and the other window's vertical scroll position.  When one of the
  198. 'scrollbind' windows is asked to vertically scroll past the beginning or end
  199. limit of its text, the window no longer scrolls, but remembers how far past
  200. the limit it wishes to be.  The window keeps this information so that it can
  201. maintain the same relative offset, regardless of its being asked to scroll
  202. past its buffer's limits.
  203.  
  204. However, if a 'scrollbind' window that has a relative offset that is past its
  205. buffer's limits is given the cursor focus, the other 'scrollbind' windows must
  206. jump to a location where the current window's relative offset is valid.  This
  207. behavior can be changed by clearing the 'jump' flag from the 'scrollopt'
  208. option.
  209.  
  210.                             *syncbind* *:syncbind*
  211. :syncbind        Force all 'scrollbind' windows to have the same
  212.             relative offset.  I.e., when any of the 'scrollbind'
  213.             windows is scrolled to the top of its buffer, all of
  214.             the 'scrollbind' windows will also be at the top of
  215.             their buffers.
  216.  
  217.                             *scrollbind-quickadj*
  218. The 'scrollbind' flag is meaningful when using keyboard commands to vertically
  219. scroll a window, and also meaningful when using the vertical scrollbar of the
  220. window which has the cursor focus.  However, when using the vertical scrollbar
  221. of a window which doesn't have the cursor focus, 'scrollbind' is ignored.
  222. This allows quick adjustment of the relative offset of 'scrollbind' windows.
  223.  
  224. ==============================================================================
  225. 6. Scrolling with a mouse wheel                *scroll-mouse-wheel*
  226.  
  227. When your mouse has a scroll wheel, it should work with Vim in the GUI.  How
  228. it works depends on your system.  It might also work in an xterm
  229. |xterm-mouse-wheel|.
  230.  
  231. For the Win32 GUI the scroll action is hard coded.  It works just like
  232. dragging the scrollbar of the current window.  How many lines are scrolled
  233. depends on your mouse driver.  If the scroll action causes input focus
  234. problems, see |intellimouse-wheel-problems|.
  235.  
  236. For the X11 GUIs (Motif, Athena and GTK) scrolling the wheel generates key
  237. presses <MouseDown> and <MouseUp>.  The default action for these keys are:
  238.     <MouseDown>        scroll three lines down.    *<MouseDown>*
  239.     <S-MouseDown>    scroll a full page down.    *<S-MouseDown>*
  240.     <C-MouseDown>    scroll a full page down.    *<C-MouseDown>*
  241.     <MouseUp>        scroll three lines up.        *<MouseUp>*
  242.     <S-MouseUp>        scroll a full page up.        *<S-MouseUp>*
  243.     <C-MouseUp>        scroll a full page up.        *<C-MouseUp>*
  244. This should work in all modes, except when editing the command line.
  245.  
  246. Note that <MouseDown> is used for scrolling the text down, this happens when
  247. you turn the mouse wheel up!
  248.  
  249. You can modify this behavior by mapping the keys.  For example, to make the
  250. scroll wheel move one line or half a page in Normal mode: >
  251.    :map <MouseDown> <C-Y>
  252.    :map <S-MouseDown> <C-U>
  253.    :map <MouseUp> <C-E>
  254.    :map <S-MouseUp> <C-D>
  255. You can also use Alt and Ctrl modifiers.
  256.  
  257. This only works when Vim gets the scroll wheel events, of course.  You can
  258. check if this works with the "xev" program.
  259.  
  260. When using Xfree86, the /etc/XF86Config file should have the correct entry for
  261. your mouse.  For FreeBSD, this entry works for a Logitech scrollmouse: >
  262.     Protocol     "MouseMan"
  263.     Device       "/dev/psm0"
  264.     ZAxisMapping 4 5
  265. See the Xfree86 documentation for information.
  266.  
  267.                             *xterm-mouse-wheel*
  268. To use the mouse wheel in a new xterm you only have to make the scroll wheel
  269. work in your Xserver, as mentioned above.
  270.  
  271. To use the mouse wheel in an older xterm you must do this:
  272. 1. Make it work in your Xserver, as mentioned above.
  273. 2. Add translations for the xterm, so that the xterm will pass a scroll event
  274.    to Vim as an escape sequence.
  275. 3. Add mappings in Vim, to interpret the escape sequences as <MouseUp> or
  276.    <MouseDown> keys.
  277.  
  278. You can do the translations by adding this to your ~.Xdefaults file (or other
  279. file where your X resources are kept): >
  280.  
  281.   XTerm*VT100.Translations:        #override \n\
  282.         s<Btn4Down>: string("0x9b") string("[64~") \n\
  283.         s<Btn5Down>: string("0x9b") string("[65~") \n\
  284.         <Btn4Down>: string("0x9b") string("[62~") \n\
  285.         <Btn5Down>: string("0x9b") string("[63~") \n\
  286.         <Btn4Up>: \n\
  287.         <Btn5Up>:
  288.  
  289. Add these mappings to your vimrc file: >
  290.     :map <M-Esc>[62~ <MouseDown>
  291.     :map! <M-Esc>[62~ <MouseDown>
  292.     :map <M-Esc>[63~ <MouseUp>
  293.     :map! <M-Esc>[63~ <MouseUp>
  294.     :map <M-Esc>[64~ <S-MouseDown>
  295.     :map! <M-Esc>[64~ <S-MouseDown>
  296.     :map <M-Esc>[65~ <S-MouseUp>
  297.     :map! <M-Esc>[65~ <S-MouseUp>
  298. <
  299.  vim:tw=78:ts=8:ft=help:norl:
  300.